//====================================================================
//文件名称：sw.h
//功能概要：开关软件构件头文件
//版权所有：江苏电子-索明何
//版本更新：2023-01-23  V1.0
//====================================================================
#ifndef  _SW_H                //防止重复定义（开头）
#define  _SW_H

//1.头文件包含
#include  "common.h"          //包含公共要素软件构件头文件
#include  "gpio.h"            //包含GPIO底层驱动构件头文件

//2.宏定义
//(1)开关硬件构件接口引脚宏定义（由实际的硬件连接决定）
#define  SW1    (PTC|13)     //开关SW1使用的端口/引脚
#define  SW2    (PTC|14)     //开关SW2使用的端口/引脚
#define  SW3    (PTC|15)     //开关SW3使用的端口/引脚

//(2)开关状态宏定义（开关状态对应的物理电平由硬件接法决定）
#define  SW_CLOSE   0        //开关闭合
#define  SW_OPEN    1        //开关断开

//3.对外接口函数声明
//====================================================================
//函数名称：sw_init
//函数功能：对指定的某个开关进行初始化（使用MCU引脚内部上拉电阻）
//函数参数：port_pin: 开关使用的端口引脚号（可用宏定义SW1~SW3之一作为函数实参）
//函数返回：无
//函数调用示例：
//   sw_init(SW2);         //对开关SW2初始化
//====================================================================
void sw_init(uint16 port_pin);

//====================================================================
//函数名称：sw_get
//函数功能：获取指定的某个开关的状态
//函数参数：port_pin: 开关使用的端口引脚号（可用宏定义SW1~SW3之一作为函数实参）
//函数返回：开关引脚的状态（0或1）
//函数调用示例：
//    sw_get(SW2);         //获取开关SW2的状态
//====================================================================
uint8 sw_get(uint16 port_pin);

#endif                      //防止重复定义（结尾）
